Release 10.1A: OpenEdge Getting Started:
Installation and Configuration

Using the OpenEdge license file

OpenEdge creates a license file that records license-related information about OpenEdge database users. If the log file does not already exist, the broker creates it and places it in the same directory as the database (.db) file. The broker creates the file in the format databasename.lic, where databasename is the name of the database to which the user connects.

Note: If OpenEdge encounters an error while trying to open or write to the license file, the error is recorded in the database .lg file and no more entries are written to the license (.lic) file.

Reading the license file

Use a text editor to display the license file contents. The contents appear in the following order:

Current date.
Current time.
Number of licensed users specified by the configuration file.
Current number of total connections.
Maximum number of total connections.
Minimum number of total connections.
Current number of interactive connections.
Maximum number of interactive connections for the past hour.
Minimum number of interactive connections for the past hour.
Current number of batch connections.
Maximum number of batch connections for the past hour.
Minimum number of batch connections for the past hour.

For example, the following sample file entry illustrates the log format:

4/26/08 9:00 25 18 23 11 17 20 11 1 5 0

When OpenEdge writes to the license file, the maximum and minimum values are reset for the next hour.

Maintaining the license file

The database or system administrator should consider archiving license files periodically. In one year, a license file accumulates 8,760 entries. These entries occupy about 440,000 bytes of disk space.

Since the license file must be closed before the administrator archives it, the administrator must first shut down the database. At that point, the license file can be either archived immediately or renamed and archived later.

Creating a usage report

To produce a report of license-related information about current OpenEdge database users, run the licrpt.p procedure file. The report generator input screen appears:

Enter Date Range: To: Enter Start Time (hours 0 to 23): Enter Stop Time (hours 0 to 24): Enter time division (in hours, or 0 for complete range): Database Name:

This is a sample output from the licrpt.p procedure file:

Database Connection Counts -------------------------------------------------------------------------- | Date Period LcnUsers MaxTot Excptns MinTot AveTot MaxBat MinBat AvBat | |------- ------- -------- ------ ------- ------ ------ ------ ------ ----- | | 4/11/06 8-17 100 20 0 0 10. 0 0 0. | | 4/13/06 8-17 100 20 0 18 19. 0 0 0. | | 4/16/06 8-17 100 23 0 17 20. 0 0 0. | | 4/20/06 8-17 100 33 0 17 25. 0 0 0. | | 4/24/06 8-17 100 32 0 26 29. 0 0 0. | | 4/26/06 8-17 100 26 0 17 22. 0 0 0.